package com.itx.gatewayx.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.itx.gatewayx.domain.News;
import com.itx.gatewayx.domain.dto.NewsApiResponse;

import java.util.List;
import java.util.Map;

/**
 * 新闻服务接口
 *
 * @author itx
 */
public interface NewsService extends IService<News> {
    
    /**
     * 分页获取新闻列表
     *
     * @param current 当前页
     * @param size 每页大小
     * @param categoryId 分类ID(可选)
     * @return 新闻分页列表
     */
    IPage<News> getNewsList(Long current, Long size, String categoryId);
    
        /**     * 获取新闻详情     *     * @param newsId 新闻ID     * @param userId 当前用户ID(可选，用于判断是否点赞、收藏)     * @return 新闻详情     */    News getNewsDetail(String newsId, Long userId);
    
    /**
     * 发布新闻
     *
     * @param news 新闻信息
     * @param tags 标签列表
     * @return 是否成功
     */
    boolean publishNews(News news, List<String> tags);
    
    /**
     * 更新新闻
     *
     * @param news 新闻信息
     * @param tags 标签列表
     * @return 是否成功
     */
    boolean updateNews(News news, List<String> tags);
    
        /**     * 删除新闻     *     * @param newsId 新闻ID     * @param userId 操作用户ID(用于权限验证)     * @return 是否成功     */    boolean deleteNews(String newsId, Long userId);
    
        /**     * 点赞/取消点赞新闻     *     * @param newsId 新闻ID     * @param userId 用户ID     * @param isLike true-点赞, false-取消点赞     * @return 是否成功     */    boolean likeNews(String newsId, Long userId, boolean isLike);
    
        /**     * 收藏/取消收藏新闻     *     * @param newsId 新闻ID     * @param userId 用户ID     * @param isFavorite true-收藏, false-取消收藏     * @return 是否成功     */    boolean favoriteNews(String newsId, Long userId, boolean isFavorite);
    
    /**
     * 获取热门新闻
     *
     * @param limit 条数限制
     * @return 热门新闻列表
     */
    List<News> getHotNews(int limit);
    
    /**
     * 搜索新闻
     *
     * @param current 当前页
     * @param size 每页大小
     * @param keyword 关键词
     * @return 新闻分页列表
     */
    IPage<News> searchNews(Long current, Long size, String keyword);
    
    /**
     * 获取用户发布的新闻
     *
     * @param current 当前页
     * @param size 每页大小
     * @param userId 用户ID
     * @return 新闻分页列表
     */
    IPage<News> getUserNews(Long current, Long size, Long userId);
    
    /**
     * 获取用户收藏的新闻
     *
     * @param current 当前页
     * @param size 每页大小
     * @param userId 用户ID
     * @return 新闻分页列表
     */
    IPage<News> getUserFavorites(Long current, Long size, Long userId);

    /**
     * 从第三方API获取新闻数据
     *
     * @param params 请求参数
     * @return 新闻API响应
     */
    NewsApiResponse fetchNewsFromApi(Map<String, String> params);

    /**
     * 保存新闻数据
     *
     * @param newsList 新闻列表
     */
    void saveNewsList(List<News> newsList);

    /**
     * 从API响应转换为新闻实体对象
     *
     * @param response API响应
     * @return 新闻列表
     */
    List<News> convertFromApiResponse(NewsApiResponse response);

    /**
     * 获取最新新闻列表
     *
     * @return 新闻列表
     */
    List<News> getLatestNews();

    /**
     * 根据分类获取新闻列表
     *
     * @param category 分类
     * @return 新闻列表
     */
    List<News> getNewsByCategory(String category);

    /**
     * 分页查询新闻列表
     *
     * @param page 分页对象
     * @param news 查询条件
     * @return 分页结果
     */
    Page<News> queryNewsPage(Page<News> page, News news);
} 